home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 11 / Cream of the Crop 11-2.iso / extra_2 / oh2b19a.zip / README.TXT < prev    next >
Text File  |  1995-11-10  |  54KB  |  1,029 lines
  1.                       Copyright 1995, Hyperion Softword
  2.  
  3.                     *************************************
  4.                     *  Orpheus 2, beta release 2.00.17  *
  5.                     *************************************
  6.  
  7.                 Comments and queries to:  Hyperion Softword,
  8.                 535 Duvernay, Sherbrooke, QC J1L 1Y8, Canada
  9.                     tel/fax - 819-566-6296 (Rod Willmot)
  10.                        email - willmot@interlinx.qc.ca
  11.  
  12.  
  13.     ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
  14.     (((((((((((((((((   Orpheus 2 {beta} User's Guide   ))))))))))))))))))
  15.     ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
  16.  
  17. Last revised: November 8, 1995
  18.  
  19.  
  20.     TABLE OF CONTENTS
  21. ==============================================================================
  22.  
  23.     Notice
  24.     Shareware
  25.     Acknowledgments
  26.  
  27.     Part I - Setup
  28.         1. Introduction
  29.         2. Installing Orpheus 2
  30.         3. Notes for Beta Testers
  31.  
  32.     Part II - A Look Around
  33.         4. What's New
  34.         5. What's Missing
  35.  
  36.     Part III - Tutorial
  37.         6. Starting a new project
  38.         7. Making a Link
  39.         8. Navigating Links
  40.         9. Importing Text
  41.         10. Loading an existing Project
  42.         11. Building a finished Product
  43.  
  44.     Appendix - How to Order
  45.  
  46. ==============================================================================
  47.  
  48.  
  49.  
  50.                                  = Notice =
  51. :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
  52.  
  53.   * THIS IS A BETA RELEASE.  In using it you automatically become a beta
  54.     tester.  Please see "Notes for Beta Testers" below, even if you do
  55.     not intend to send in bug reports.
  56.  
  57.   * THIS FILE IS NOT A MANUAL.  99% of the documentation for Orpheus 2 is
  58.     in online Help.  (Press <F1> in OH.EXE for context-sensitive help from
  59.     any menu, dialog, or other situation.)  I'll write the gentle tutorials
  60.     as soon as I can, but in the meantime too many users are pleading to
  61.     work with Orpheus 2 for me to delay it any longer.  Trust yourself,
  62.     plunge in, read Help, browse the menus, read more Help, and keep in
  63.     touch!
  64.  
  65.   * If you have projects developed with Orpheus 1.nn, you can use the
  66.     included utility OH1TO2.EXE to convert them to the new file formats
  67.     used by Orpheus 2.  See OH1TO2.TXT for more information.  Do not mix
  68.     up Orpheus 2 files with your old files!
  69.  
  70.  
  71.  
  72.  
  73.                                 = Shareware =
  74. :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
  75.  
  76.   * Orpheus is currently distributed as shareware.  As an unregistered user
  77.     you are welcome to evaluate this copy for up to 30 days.  You may not
  78.     distribute anything you might create with Orpheus 2, in any way, without
  79.     purchasing a registered copy.  Documents created with an unregistered copy
  80.     invoke a warning message when performed by the Reader.
  81.  
  82.   * The price of Orpheus is $79 US, plus shipping.  Yes, you can register
  83.     with your credit card!  For full details please see "How to Order" at
  84.     the end of this file, or use the order form provided in REGISTER.TXT.
  85.  
  86.   * If you purchased an earlier version of Orpheus you are entitled to an
  87.     upgrade.  Users who registered at the full current price of $79 US will
  88.     receive a free upgrade directly from me, as soon as Orpheus 2 is deemed
  89.     complete.  If you hunger to get ahold of it quicker than that, give me a
  90.     call.  If you are unsure of your status and wish to know what an upgrade
  91.     will cost (if anything), give me a call.  But not before 12 noon.  The
  92.     code I write at 6:00 a.m. *may*be*for*you*.
  93.  
  94.  
  95.  
  96.  
  97.                              = Acknowledgments =
  98. :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
  99.  
  100.   * Warm thanks to the beta testers who have contributed to the story
  101.     so far:  Ray Ballard, Andy Roberts.
  102.  
  103.   * Thanks in many tongues to those who have worked so hard to provide
  104.     translations of the Orpheus Reader (in French, Dutch, German, Italian,
  105.     and Portuguese):  Daniel Marois, Jan Moens, Jurgen Nijhuis, Thorsten
  106.     Glattki, Giovanni Calesini, Jesus de Paula Assis.
  107.  
  108.   * Special thanks to the tireless sysop of Synapse BBS, Daniel Coulombe.
  109.  
  110.   * Orpheus uses the SPAWNO routines by Ralf Brown to minimize memory
  111.     use while shelling to DOS and running other programs.
  112.  
  113.  
  114.  
  115.                              = Part I - Setup =
  116. :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
  117.  
  118. -----------------------
  119.     1. Introduction
  120. =======================
  121.     What is Orpheus?
  122.     System requirements
  123.     What can it do?
  124.     Windows version
  125.     Shareware...
  126.  
  127.     What is Orpheus?  Orpheus is a hypertext authoring system.  It is
  128. designed for the creation of compiled hypertext documents that can be read
  129. with the Orpheus Reader.  Registered users may distribute such documents
  130. (together with the Reader) any way they please:  on disk, over BBS systems and
  131. the Internet, or installed on a LAN.
  132.  
  133.     System requirements:  Orpheus runs on any IBM-compatible PC from
  134. the XT on up to the Pentium.  Orpheus is currently a DOS-based system,
  135. requiring DOS 3.1 or higher; it runs very happily under Windows and OS/2.
  136. The authoring program requires a hard disk and at least 512K of RAM; for
  137. best performance XMS is desirable.  The Reader can run on diskette, and
  138. survives on much less RAM.
  139.  
  140.     What can it do?  Orpheus 2 has a capacity of over 2 million linked
  141. nodes in a single document.  Text cards can be of any length.  Graphics
  142. support now includes SVGA modes, and you can display PCX, GIF, and FLI/FLC
  143. files.  Through script commands you can create a work that interacts
  144. exquisitely with the user.  You can modify the appearance and behavior of the
  145. Orpheus Reader so that it looks like it was custom-programmed for you.
  146.  
  147.     Windows version:  The code in Orpheus 2 was designed for easy portability
  148. to Windows-based programming.  As soon as Orpheus 2 is complete, I will begin
  149. work on a Windows version of the Reader.
  150.  
  151.     Shareware...  Yes, Orpheus 2 is shareware, as was Orpheus 1.  If you are
  152. not a registered user of Orpheus 2, you are welcome to evaluate it for up to
  153. 30 days; you are NOT permitted to distribute (in any way) works that you may
  154. have created with Orpheus 2.  The price of Orpheus 2 is $79 US, plus shipping.
  155. If I haven't provided ordering information in this release, please contact me
  156. by one of the methods given at the top of this file.  NOTE:  registered users
  157. of Orpheus 1.nn can receive an upgrade; please contact me.
  158.  
  159.  
  160.  
  161. -------------------------------
  162.     2. Installing Orpheus 2
  163. ===============================
  164.     Orpheus 1 users
  165.     Orpheus 2 "Interim Version"
  166.     Typical installation
  167.  
  168.     Orpheus 1 users:  If you have used Orpheus 1 in the past, be sure to
  169. install Orpheus 2 in a completely different directory.  The only "contact"
  170. between the versions should be via the Converter, OH1TO2.EXE, if you intend
  171. to convert your old projects to the new system.
  172.  
  173.     Orpheus 2 "Interim Version" users:  do as above.  The file formats of
  174. the "real" Orpheus 2 (this one) bear no similarity to the Interim Version.
  175. User the Converter to change your Interim projects to the new system (see
  176. OH1TO2.TXT).
  177.  
  178.     Typical installation:  Place your Orpheus 2 files into a directory of
  179. their own on your hard drive, such as:
  180.  
  181.             C:\OH2
  182.  
  183. From now on you can use that location as your "working directory" for all
  184. of your projects.  For example, in DOS you would switch to that directory
  185. and start up OH.EXE with the command "OH"; your projects would be based in
  186. that directory, with their files all stored in subdirectories created for
  187. you by Orpheus.  See below in this file for discussion of starting a new
  188. project and loading an existing project.
  189.  
  190.  
  191.  
  192. ---------------------------------
  193.     3. Notes for Beta Testers
  194. =================================
  195.     Memcheck
  196.     Debug functions
  197.     Known bugs
  198.  
  199. Check out UPDATE.TXT for a list of changes, fixes, and new features.
  200.  
  201. Memcheck
  202. ============
  203. Beta versions of Orpheus now incorporate the Memcheck debugging tool
  204. from StratosWare Corporation.  Besides helping you discover bugs, Memcheck
  205. will protect your work and your system from unexpected behavior.  To activate
  206. Memcheck your DOS environment must include the MEMCHECK variable, which is
  207. done by giving the following command at the DOS prompt, =before= running
  208. OH.EXE:
  209.  
  210.     SET MEMCHECK=1
  211.  
  212. This command can be placed in your autoexec.bat file, or in a batch file
  213. used only for running the beta.  The following batch file could be named
  214. OH2.BAT or BETA.BAT, and would optionally pass a project-name parameter to
  215. Orpheus:
  216.  
  217.     SET MEMCHECK=1
  218.     OH %1
  219.     SET MEMCHECK=
  220.  
  221. The last command removes the MEMCHECK variable from your DOS environment,
  222. and can also be given manually.  Whenever Memcheck encounters a serious
  223. memory-related error while you are running OH.EXE, a message box will
  224. pop up reporting the problem.  Please note what the message says, along
  225. with some indication of what you had been doing before the error occurred.
  226. When you press a key to clear the message, Orpheus will safely exit.
  227.  
  228. I find that debugging is especially convenient under Windows, i.e. in a
  229. DOS box.  If the program appears to freeze -- no disk activity, no
  230. response to the keyboard -- you can safely terminate it using the Windows
  231. trick of pressing Alt-Space, selecting "Settings", then "Terminate".
  232.  
  233. NOTE:  Memcheck code is also present in the Simulator and the Reader, but
  234. not in Help.  Does this have any bearing on whether you can distribute a
  235. beta version of the Reader to your users?  None at all.  Unless they
  236. themselves set the MEMCHECK variable on their systems, the Memcheck code
  237. does not run.
  238.  
  239.  
  240. Debug functions
  241. ===================
  242. Currently the F11 and F12 keys (in OH.EXE) are reserved for debug functions,
  243. which vary depending on the current focus.  Pressing one of those keys
  244. alone or in combination with Shift, Alt, or Control may or may not
  245. produce a message box or effect.  One function that I RECOMMEND you use
  246. from time to time is <F12>, which displays the contents of the memory
  247. page holding the line at the cursor.  To clear the display and refresh
  248. the whole screen, press any key.  This is an easy way to get a full
  249. refresh when something odd has happened during word-processing.  More
  250. important, the display can show you an error condition that Orpheus hasn't
  251. caught, if you know what to look for.
  252.  
  253. Briefly:  bytes with an ascii value of 0 are displayed (in this debug
  254. function) as ascii 254, a square block.  If the memory page includes any
  255. unused bytes they will be displayed as a stream of these in bright white on
  256. black.  If the bright white stream includes any OTHER characters, this is an
  257. error condition.  Here's what to do:  (1) if you can, make a note of what you
  258. were doing before the condition arose (reformatting?  deleting?  block ops?);
  259. (2) to wipe out the error condition, press <F2> to save the file to disk, then
  260. select "Reread" from the File Menu to read in the saved copy.  The errant
  261. characters will be lost but the rest will be okay.
  262.  
  263. NOTE:  In the Reader and the Simulator, pressing <F12> pops up a message
  264. indicating the amount of free memory in the near and far heap.  This will
  265. not of course happen in non-beta releases of these programs.
  266.  
  267.  
  268. Known bugs
  269. ==============
  270. The only bugs currently known to me are in OH.EXE's word processor, affecting
  271. some block operations (column move, occasionally a stream block, never to my
  272. knowledge a line block) and autoreformat.  Also, in some circumstances a
  273. multi-line delete at the end of a card causes the cursor to think it's on the
  274. wrong line.  The best way to clear any such problem, short of exiting the
  275. program, is to press <Ctl-Home> (using the middle keypad), which jumps to
  276. the top of the current card and resets the cursor position.
  277.  
  278. With the exception of autoreformat and column block moves I've made heavy
  279. use of most of the word-processing functions in the course of developing
  280. the online Help -- nearly half a megabyte of text before compression.
  281. The linking and project-building functions, as well as Help, the Reader,
  282. and the Simulator, perform beautifully.  Areas of the Reader that need
  283. pushing (to see what's missing and what might break) are the script handling,
  284. especially with graphics.
  285.  
  286.  
  287.  
  288.                          = Part II - A Look Around =
  289. :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
  290.  
  291. ---------------------
  292.     4. What's New
  293. =====================
  294.     Ascii file format
  295.     Scrollable text
  296.     Better linking
  297.     System capacity
  298.     Better compiling
  299.     Improved compression
  300.     Simpler Reader
  301.     Customize Reader interface
  302.     Disable Reader elements
  303.     Selector keys in Reader
  304.     Extended graphics support
  305.     Hotspots improved
  306.     Menu() command
  307.     Ask() command
  308.     Run() & Runbat() improved
  309.     Data Fields
  310.     Color schemes
  311.     The Simulator
  312.  
  313.  
  314.     * Ascii file format:  Uncompiled cards are now plain text files.  This
  315. means that you can create them with any text editor, though more commonly
  316. you'll switch into ascii mode (within OH.EXE) for plain-text editing.  In
  317. ascii mode you can see the link codes and edit them manually (it's easy).  The
  318. great advantage of the new file format:  if something goes wrong, you can fix
  319. it.  In Orpheus 1 the files were semi-binary, and trouble meant trouble.
  320.  
  321.     * Scrollable text:  Text cards can be scrollable if you wish, with no
  322. restriction on length.  Many users of Orpheus 1 liked the screen-sized cards,
  323. and you can still use them if you don't like scrolling, or limit scrolling
  324. to particular cards.
  325.  
  326.     * Better linking:  First, link numbers now correspond in a perfectly
  327. obvious way to the filenames of the cards they point to.  Second, linking
  328. itself is more flexible, and as mentioned above, easy to do manually in the
  329. rare cases when you need to.  Crosslinks (as a link type) are toast; now you
  330. can link anywhere as often as you want, using the standard link types.  There
  331. are several new link types, including Exit links (actions to perform when a
  332. user leaves a card), Private links (they don't go into the finished product),
  333. Report links (to print instead of the card shown onscreen), and more.  Orpheus
  334. two extends the use of link codes to handle embedded labels and hilites; both
  335. dress up the text with color, and labels can also be used as link targets.
  336.  
  337.     * System capacity:  The new system is built to handle over 2 million
  338. unique nodes, i.e. individual linked cards, of which Text cards can be of
  339. any length.  Finished products are designed for extremely fast performance
  340. in the Reader, no matter how large the work.
  341.  
  342.     * Incremental compiling:  The old system combined all phases of finished-
  343. product-making into one process, which you had to repeat from the beginning
  344. if an error was encountered.  Orpheus 2 separates "building" into three
  345. stages:  compiling cards into their individual finished, compressed form,
  346. in which they are stored in CMP files; verifying the links to all possible
  347. cards in the work, starting from the Homecard; assembling all compiled cards
  348. (and other elements) into a finished product.  The first stage, compilation,
  349. can now be performed incrementally; once a given card has been compiled you
  350. no longer have to recompile it, no matter how often you compile new cards
  351. or assemble versions of the finished product.  This is a huge time-saver.
  352.  
  353.     * Improved compression:  Finished products are now significantly smaller
  354. than under Orpheus 1, particularly if you take advantage of the ability to
  355. use scrollable text (as opposed to stringing together many screen-sized
  356. cards using "More" links).  Along with this there is better security:  whereas
  357. an HTX compiled with Orpheus 1 could be deciphered without difficulty, and
  358. certain parts could be left in plain text, under Orpheus 2 an HTX file looks
  359. like 100% binary garbage.  Any part too small to compress efficiently is
  360. encrypted.
  361.  
  362.     *Improved distribution:  In terms of finished output, the old system
  363. produced a small HTX file with at least one numbered subfile; subfiles were
  364. limited to 64K.  Orpheus 2 lets you set the maximum filesize up to 1 megabyte,
  365. which includes the HTX file.  This means you can now assemble most projects
  366. into *one* file, the HTX, for simpler distribution.
  367.  
  368.     * Simpler Reader:  The old Reader had a number of automatic features that,
  369. while intended to be friendly, could be troublesome.  For example, the user
  370. could always open the menu system and shell to DOS, which could be dangerous
  371. if the Reader was being used on a BBS.  Currently the Reader for Orpheus 2
  372. is "missing" a lot of stuff that made the old one stand out, but it's clear
  373. that =authors= will be happy that the Reader no longer forces it on them.
  374. In keeping with this, whenever I add an interface-related feature to the
  375. Reader I will make it possible for authors to hide or disable it.
  376.  
  377.     * Customize Reader interface:  You can customize the Reader interface
  378. (primarily as evidenced in text mode) in a number of ways.  Open the Project
  379. Menu, select Project Options, then dig into the Screen Layout dialog.  Read
  380. online Help about this and about making command buttons.  You can make an
  381. interface all your own; an example is Help itself, which is NOT hard-coded
  382. into the Help engine, rather it was set up as the Help project's layout, and
  383. you can do the same with your own projects.
  384.  
  385.     * Disable Reader elements:  All of the built-in Reader elements (like
  386. the menu system, which =will= eventually get built in again) can be disabled
  387. through the Project Options dialog.  You can also disable the hotkeys (like
  388. the one to exit the Reader) and force the user to do things through your own
  389. popup menus and/or command buttons.
  390.  
  391.     * Extended graphics support:  Orpheus 2 now supports SVGA graphics up
  392. to mode 29.  You can display GIF graphics as well as PCX, and I've added
  393. support for animation using FLI/FLC files.
  394.  
  395.     * Hotspots improved:  Hotspots now are drawn as convex polygons rather
  396. than blocky shapes; the new method gives you the same resolution as the
  397. image onscreen, making for real precision.  In addition, hotspots can be
  398. "linked" to a sequence of script lines immediately following a hotspot
  399. command; you are no longer limited to linking hotspots to other cards.
  400.  
  401.     * Menu() command:  the new script command menu() lets you display a
  402. popup menu; you can respond to the user's menu selection to call various
  403. internal Reader functions, to perform other script commands, or to initiate
  404. a hypertext jump.
  405.  
  406.     * Ask() command:  the new script command ask() lets you display a popup
  407. dialog, similar to a standard Orpheus dialog.  You can respond to the user's
  408. selection with the same flexibility as described above for the menu() command.
  409.  
  410.     * Run() & Runbat() improved:  control whether the Reader swaps itself out
  411. before performing the command (e.g. if you're launching a very large external
  412. program you'd want the Reader to swap out).  You can also control whether the
  413. Reader clears the screen; this lets you use these commands for special effects
  414. while displaying graphics.
  415.  
  416.     * Color schemes:  Colors are now stored for three video standards -- mono,
  417. grey-scale, and color -- and if you have all three available while working you
  418. can select your own schemes for each and keep them in a single CFG file.
  419. The colors active on your system when you assemble a finished product are
  420. built into the HTX.  If you selected "Your colors" in Project Options, the
  421. user sees your work first in your colors; otherwise the default colors appear.
  422. However, if the user has a Reader CFG file present, he sees with his own
  423. colors, but can still call yours through the Color Dialog -- if you give him
  424. access to it.
  425.  
  426.     * The Simulator:  As a complement to incremental compilation, Orpheus 2
  427. gives you a way to experience your work as if you were seeing it in the
  428. Reader, but without having to produce a finished copy of it.  The Simulator
  429. works with CMP files (described above) -- the stored compiled forms of your
  430. individual cards.  The Simulator lets you test scripts realistically, and is
  431. the environment you'll use for drawing hotspots.
  432.  
  433.  
  434. -------------------------
  435.     5. What's Missing
  436. =========================
  437.  
  438. A number of useful features that were in Orpheus 1.65 haven't been plugged
  439. in yet; a few are now obsolete and won't be.  In OH.EXE, anything dimmed
  440. on the menus is obviously not ready yet.  I especially miss Search/Replace
  441. during my work on online Help, so that's high on the priority list.  The
  442. system will not be complete until you can redefine the keyboard and create
  443. macros; Orpheus 2 was designed to facilitate them, and they're coming.
  444.  
  445. Currently the only graphic file formats supported are PCX and GIF, with
  446. FLI/FLC for animation.  I should be able to add SPR and the new PNG format
  447. as I can get the code.  Many Orpheus 1 users took advantage of the
  448. ability to store graphics etc in library files; Orpheus 2 will replace
  449. this by optionally including them in the actual finished document.  It
  450. will be a whole lot easier, simplifying script commands and eliminating the
  451. need to figure out a library-management program.  It's all designed, just
  452. not coded yet!  Look for INCLUDE on the Project Menu, in future releases.
  453.  
  454. Missing from the Reader currently are 90% of the gadgets that were in
  455. Orpheus 1.65:  a Notebook, a Bookmark dialog, a Tour capability, and of
  456. course the built-in menus giving access to these things.  The only gadgets
  457. in there right now are the Print and Color dialogs, which can only be
  458. accessed if you provide your own command buttons.  Many authors will be
  459. delighted with this situation.  I do plan to work in most or all of the
  460. gadgets (improved of course), but authors will be able to hide or disable
  461. them -- a fundamental feature of Orpheus 2.
  462.  
  463. Speaking of the Reader, a very high priority around here is to provide
  464. versions of the Orpheus Reader in French, Italian, Dutch, Spanish, German,
  465. and Portuguese, others if users will help with translation.  Those listed
  466. will be ready soon!
  467.  
  468.  
  469.  
  470.  
  471.                            = Part III - Tutorial =
  472. :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
  473.  
  474. ---------------------------------
  475.     6. Starting a new project
  476. =================================
  477.  
  478. Start up OH.EXE using the command "oh" at the DOS prompt.  (Do not give a
  479. filename on the command line when you are beginning a new project.) Open the
  480. Project Menu and select "New Project".  This leads you into a sequence of
  481. three dialogs:  the first to enter a name for the project, the second to set
  482. your project options, and the third to define the project's Homecard.
  483.  
  484. (1) The first dialog prompts you for the name of a new Project File, which
  485. must end in ".PRJ".  If you enter a name without an extension, Orpheus appends
  486. .PRJ automatically; if you include an extension, it must be .PRJ. For example,
  487. you can type "TEST" and the new Project File will be named "TEST.PRJ".
  488.  
  489. (2) The second dialog lets you set various project options; these settings
  490. will apply only to the current project.  The Project Options dialog can also
  491. be accessed separately through the Project Menu, and you can set or change any
  492. option later on (with one exception) whenever you like.  The exception is the
  493. "Card Extension" used for uncompiled cards and certain other files; by default
  494. it is the first three letters of the project name, such as TES for TEST.PRJ.
  495. You can ONLY change it during the sequence for making a new project.  For now,
  496. enter a title for your work and continue.  For online Help about all of your
  497. project options, press <F1> while in this dialog.
  498.  
  499. (3) The third dialog, Define Card, opens automatically whenever a new card is
  500. created.  The settings you make in this dialog apply ONLY to the current card,
  501. and can be changed whenever you like.  For the most part the only item you
  502. will regularly concern yourself with is the Topic.  Topics are a new feature
  503. of Orpheus 2, which you can read about in online Help.  A Topic describes
  504. the subject of a card; if you make a habit of *always* entering the Topic when
  505. making a new card, you will find that you have a rich resource for providing
  506. additional forms of access to your work, plus a superb outline for your own
  507. use.  For now, type in a Topic (such as "Table of Contents") and continue.
  508. For online Help about all of your card options, press <F1> while in this
  509. dialog.
  510.  
  511. With the last dialog concluded, you are in the Homecard of your new project.
  512. As shown on the Statusbar (upper right on your screen), the Homecard is named
  513. "1-001.TES".  The window number, 1, is shown at the left of the Statusbar
  514. beside the "Esc:Menu" prompt.  The line number at the cursor, 1, is shown to
  515. the left of the filename.  For an explanation of everything you see on the
  516. Statusbar, press <F1> and select "Statusbar" from the Help Contents page.
  517.  
  518. At this point you now have the skeleton of a complete project.  Using the
  519. "TEST" example for illustration, you have a project file (TEST.PRJ), a
  520. Homecard (1-001.TES), a project directory with the same name as your
  521. project, and the first storage directory for uncompiled cards.  Supposing
  522. that you installed Orpheus 2 in a directory named C:\OH2, here is what
  523. you would have:
  524.  
  525.     C:\OH2\TEST.PRJ                - project file for TEST project
  526.     C:\OH2\TEST\                   - project directory for TEST project
  527.     C:\OH2\TEST\DIR1\              - first storage directory in project
  528.     C:\OH2\TEST\DIR1\1-001.TES     - default Homecard for the project
  529.  
  530. If you have been using earlier versions of Orpheus you'll notice some
  531. differences here -- for the better.  For an explanation of how Orpheus 2
  532. names and stores your files, press <F1> and select "Files & Directories"
  533. from the Help Contents page.
  534.  
  535.  
  536.  
  537. ------------------------
  538.     7. Making a Link
  539. ========================
  540.  
  541. The next step is to begin entering text and making links.  If you are new
  542. to Orpheus, at this point you might appreciate a little clarification.  In
  543. some hypertext systems, you start off with a collection of your own existing
  544. files and proceed to create links among them; the links might be stored
  545. separately in a database, or added to your files in the form of special codes.
  546. Orpheus takes a different approach.  All parts of an uncompiled Orpheus
  547. project are special files created for you by Orpheus and stored in special
  548. directories.
  549.  
  550.     Hypertext files are called "cards" in Orpheus; they are actually plain
  551.     ascii text files (in Orpheus 2).  What's special about them is that,
  552.     (1) each begins with a one-line "header" with certain information about
  553.     it, and (2) each has a unique filename identifying it as a numbered part
  554.     of the project.  For example, the Homecard created in the previous
  555.     section, if you typed in the suggested Topic, would have a header line
  556.     something like "OH(TEXT,"Table of Contents")".  This means that it's a
  557.     Text card whose Topic is "Table of Contents".  As for the number of the
  558.     card, in this case 1-001, its significance is that whenever you make a
  559.     link to that card the target code is just "1-1".  You don't have to type
  560.     in long filepaths that could become invalid, in fact normally you don't
  561.     type in linking codes at all -- Orpheus does it for you.
  562.  
  563. Whenever you want to add a new part to an Orpheus project, you begin by
  564. making a link to a new blank card; then you jump to that card and either
  565. type in or import whatever you want that part to contain.  Suppose then
  566. that you have a collection of text files that you want to turn into hypertext
  567. using Orpheus.  You'll proceed by importing them, either whole or a section
  568. at a time, into card files created on demand as your project grows.  You
  569. can also compose new material in a card just by typing it -- the heart of
  570. OH.EXE is a word processor -- and you can make as many crosslinks as you want
  571. between cards in the same project.
  572.  
  573. So let's try this out.  Assuming you're in the Homecard, type in something
  574. like "Table of Contents", hit <Enter> a few times to bring the cursor down,
  575. and type in "Chapter 1: Excited about Oatmeal".  We'll make a link on the
  576. chapter title, automatically generating a new blank card as the target of
  577. the link.
  578.  
  579.     1. If you are new to Orpheus, put the cursor on the word "Chapter" or
  580.     click on it with the mouse.  If you already know Orpheus, mark the
  581.     entire title.
  582.  
  583.     2. Now press <Alt-L> to open the Link Menu; we'll make this a "Door"
  584.     link, the standard link type when the target is a Text card.  Press <Enter>
  585.     to select "Door", and follow the dialogs.
  586.  
  587.     3. If you didn't start off by marking the link anchor, Orpheus will hilite
  588.     the word at the cursor and let you "resize" the anchor -- extend it left
  589.     or right to include the whole title.  If you did start off by marking it,
  590.     Orpheus skips this stage.
  591.  
  592.     4. The next step is a dialog concerning the number that will be assigned
  593.     to the new blank card.  Since Orpheus has already figured out the next
  594.     available number (in this case 1-002), normally you'll just hit <Enter>
  595.     here; do it.
  596.  
  597.     5. Now the Define Card dialog comes up.  You saw this earlier when you
  598.     were making your Homecard.  As before, Orpheus really wants you to provide
  599.     a Topic for the card, so type in something like "Why I get mushy over
  600.     oatmeal".  You don't =have= to do anything else in this dialog, but
  601.     later on, if you want to change some of the "built-in" features of that
  602.     card, you can open the Define Card dialog through the Card Menu.
  603.  
  604.     6. Finally, one last dialog comes up to select a window for the new
  605.     card.  (To learn about Orpheus 2's window capabilities, press <F1>
  606.     while in this dialog, or select "Edit Windows" from the Help Contents
  607.     page.)  Whenever you create a new card, Orpheus gives you the following
  608.     options:  (a) load it in the current window, replacing whatever is there
  609.     at the time; (b) load it in another open window, replacing whatever is
  610.     there at the time; (c) load it in a new window, unless you already have
  611.     9 windows open (the limit); or (d) don't load it at all.  Note that if
  612.     you choose options (a) or (b), the existing contents of those windows
  613.     ARE NOT ERASED, though they are removed from memory.  Instead, they're
  614.     left safely on disk as your cards or other files, and you can get to them
  615.     again whenever you wish.
  616.  
  617.     For the present demonstration, hit <Enter> to load the new card in a
  618.     new window.
  619.  
  620. If you've followed step by step through this little tutorial, you are now
  621. looking at a blank card linked to the Homecard.  Type in something
  622. scintillating, like "Some people call oatmeal "porridge", and I just think
  623. that's horrid." Press <F2> to save your wisdom.
  624.  
  625.  
  626.  
  627. ---------------------------
  628.     8. Navigating Links
  629. ===========================
  630.  
  631. Now for a brief test of hypertext navigation in Orpheus.  We'll assume that
  632. you have followed the tutorial so far and are looking at card 1-002.TES
  633. loaded in window 2 (the window number is on the Statusbar, just right of
  634. "Esc:Menu").  Using the number keypad, press the <Home> key.  This should
  635. take you back to your Homecard with the Table of Contents.
  636.  
  637.     If it didn't, you have an XT or perhaps a laptop; press the NumLock key to
  638.     turn on navigation, then press <Home>.
  639.  
  640. Note that besides being back in the Homecard, you are also back in window 1.
  641. This is because OH.EXE checks whether the card you're jumping to is already
  642. in another window, and if so, switches windows instead of reloading the card
  643. from disk.  Now let's jump through the link anchor you made earlier:  click
  644. on any part of it to set the cursor there (use the left button for this), then
  645. click right on the cursor.  Or using the number keypad, press <Down> to move
  646. the cursor to the link anchor, then press <Right> to jump through it.
  647.  
  648. Once again we're in card 1-002.TES and in window 2.  Time to find out whether
  649. these WINDOWS have anything to do with your hypertext CARDS (they don't).
  650. Let's close window 2.  Press <Alt-F2> to close the current window, or go the
  651. long way around by opening the Window Menu -- <Alt-W> -- and selecting
  652. "Close".  This puts us back in window 1 and the Homecard, and you can verify
  653. that this is the only window by pressing <Ctl-F2>, which opens the Window List
  654. dialog.  Only window 1 is open.  The purpose of this exercise is to show you
  655. that your cards have an existence independent of what windows they're loaded
  656. in (or not loaded in), and that the links you make are permanent until you
  657. change them.  To prove it, jump through the link anchor as you did in the
  658. previous paragraph.  Notice that after the jump you're still in window 1.
  659. This time we'll return to the Homecard by using the Retrace method (retraces
  660. your steps):  click the right button, or press <Left> on the number keypad.
  661.  
  662. Now we'll do the jump one more time, but will use a trick to load the target
  663. card in a DIFFERENT window.  Hold down the <Ctl> key, then do whatever you
  664. did before to jump through the link anchor -- click on the cursor after
  665. setting it on the link anchor, or press <Down> to it then <Right>.  This time,
  666. because you were holding down <Ctl>, Orpheus opens the "Select Window for
  667. Jump" dialog.  Press <Enter> to select the offered window, which is #2.
  668. To verify that both cards are now loaded in separate windows, press either
  669. <Alt-V> or <Ctl-V> a few times (until you tire of switching windows).
  670.  
  671. Each of the 9 edit windows in OH.EXE can hold any text file of any length,
  672. including of course your own cards in a project.  You can load different
  673. windows with the same card, to work with different parts of it.  You can
  674. hide windows to facilitate rapid switching between those you're working in.
  675. For more information, go to the Contents page of Help and click on "Edit
  676. Windows" or on "Window" at the bottom.
  677.  
  678. Perhaps right now you're finding all this flexibility a wee bit complicated.
  679. Okay, YOU can master it sure enough, but will your eventual readers have to
  680. know all this when they get your finished products.  No way.  The Orpheus
  681. Reader offers a much simpler navigational interface and does it all in a
  682. single window (the screen!).  Moreover, you can customize many aspects of the
  683. Reader's functionality, including which keys on the keyboard perform
  684. navigation.  For more information go to the Contents page of Help and click
  685. on "Customizing a Project".
  686.  
  687.  
  688.  
  689. -------------------------
  690.     9. Importing Text
  691. =========================
  692.  
  693. In Orpheus 2, you no longer have to load external files into a special
  694. Fileview window in order to import text from existing files.  All windows are
  695. now Edit windows, each can hold any text file of any length, and each file can
  696. have its own marked blocks.
  697.  
  698. There are two ways to import text in Orpheus 2:  the quick way imports an
  699. entire file at once; the slow way lets you import selected blocks.  For the
  700. quick way, place the cursor on the line where you want the imported text to
  701. begin; now open the File Menu and select "Import File", then type in the name
  702. of the file to import, or <Tab> to the Files box and choose it from the list.
  703. (Use one of the smaller TXT files for purposes of demonstration.)  The entire
  704. file is copied into the current card, beginning at the line where you left the
  705. cursor.  (If there was already text at or below that line, it is moved to the
  706. end of the imported material.)
  707.  
  708. To import selected blocks of text you will use a slightly different procedure.
  709. Open the File Menu, select "Open", then choose the file to load, such as this
  710. one, README.TXT.  Assuming you're following this tutorial and haven't filled
  711. all 9 windows yet, the file will be loaded into the next available window.
  712.  
  713.     README.TXT uses the angle brackets "<>" to indicate keypresses such as
  714.     <F1>.  This is an ancient convention decided upon by wizards (at a
  715.     convention) and I see nothing wrong with it.  However, Orpheus 2 uses the
  716.     same symbols to indicate embedded hypertext links.  If you switch windows
  717.     over to the one containing the Homecard, you can see the link embedded
  718.     around your chapter title by pressing <Ctl-F1>.  Press <Ctl-F1> again
  719.     to see the link anchor the way we all prefer.  What you've just done
  720.     is toggle back and forth between "ascii mode" (where you see everything
  721.     just as it is) and "hyper mode" (where embedded codes are hidden and
  722.     link anchors are colored).  If you look at the statusbar to the right
  723.     of center, notice that a ∞ symbol (infinity) appears when you're in
  724.     hyper mode, while a ≡ symbol (sheaf of papers) appears in ascii mode.
  725.  
  726.     Get back into hyper mode and switch windows over to the README.TXT.
  727.     Scroll or page down a bit, and pretty quickly Orpheus will pop up a
  728.     message box saying "Incomplete or misplaced link codes".  This is
  729.     because Orpheus tries to interpret what it thinks are embedded link
  730.     codes, and informs you of what seems to be an error.  Press <Enter> to
  731.     clear the message; note that Orpheus has switched automatically into
  732.     ascii mode.  NOW if you switch windows back to your Homecard you'll
  733.     notice that you're still in ascii mode even though your hypertext cards
  734.     are error-free.  (I may change this behavior, but not the next part.)
  735.     Get back into hyper mode while in the Homecard, then switch windows back
  736.     to README.TXT.  Notice that Orpheus has figured out what you want: the
  737.     window with README.TXT stays in ascii mode (without an error message)
  738.     and the windows with your cards stay in hyper mode.
  739.  
  740. Let's see, what were we... Oh yeah, importing text.  To import a selected
  741. block of text rather than a complete file, start by loading the source
  742. file (in this case README.TXT) into another window; you've just done that.
  743. Now mark the text you wish to import.  The easy way (and the safest if
  744. you have a BETA version of Orpheus 2) is to place the cursor on the first
  745. line of the text you want, press <F7> to begin line marking, scroll down
  746. to the end of what you want, and press <F7> again to end marking.  Now
  747. switch windows to one of your cards.  Place the cursor where you want to
  748. insert the imported text, and press <Shift-F3> to copy it there.  Since that
  749. is the Copy-from-window command, Orpheus opens a dialog to let you select
  750. the window with the block you wish to copy; there's only one right now, so
  751. just press <Enter>.  With the copy complete, press <F5> to unmark the
  752. inserted copy, or <F4> if you've changed your mind (this deletes it).  Now
  753. return to README.TXT, where your original marked block is still there.  Press
  754. <F5> to unmark it.
  755.  
  756. One final point:  if any of the text you import into a hypertext card
  757. contains the <> angle bracket characters (for non-linking purposes), you will
  758. have to "escape them" before Orpheus will consider your cards error-free.
  759. This is a simple matter of inserting a backslash "\", which wizards refer to
  760. as an escape code, in front of each such character.  You'll also have to do
  761. this if you wish to *display* a backslash, i.e. you'll need "\\" in order
  762. to see "\".  HOT TIP: if you type a <, a >, or a \ while in HYPER MODE,
  763. Orpheus automatically inserts the escape code \ in front of it.
  764.  
  765. For more information on linking codes, go to the Contents page in Help
  766. and click on "Hypertext Links", then "Codes used in embedded links" or
  767. "Using the escape code".
  768.  
  769. By the way, this may be a good time to mention that you can get Help on
  770. all kinds of things without having to navigate through Help itself.  For
  771. example, if you open the File Menu and click the right mouse button (not
  772. the left) on "Import File", Orpheus pops up Help on exactly that subject.
  773. Or do it with the keyboard:  move the menu selection bar to "Import File"
  774. and press <F1>.
  775.  
  776.  
  777. ---------------------------------------
  778.     10. Loading an existing project
  779. =======================================
  780.  
  781. Before exploring any other facets of Orpheus 2, let's see how to reload your
  782. new project in a later session.  First, press <Alt-F4> to quit OH.EXE (or open
  783. the File Menu and select "Exit").  At the beginning of this tutorial, you
  784. started up OH.EXE with just the "oh" command at the DOS prompt (without any
  785. parameters).  Now that you've created a project, you can reload it when you
  786. start OH.EXE by adding its name to the command line.  For example, to reload
  787. the TEST project you would enter "oh test".
  788.  
  789. After reloading the TEST project, check your windows and observe that
  790. everything is as you left it when you exited.  Whenever you quit a project,
  791. either in exiting the program or in switching to a different project, Orpheus
  792. saves your desktop for the project in a STATUS file, stored in the project
  793. directory.
  794.  
  795. You can also start up OH.EXE with "oh", then open the Project Menu, select
  796. "Open Project", and type in the name of the project to load.  Use the same
  797. method later to switch from one project to another.  (Since you can only load
  798. one project at a time, Orpheus saves the current project's STATUS file, clears
  799. all windows, then loads the new project after reading it's STATUS file.)
  800.  
  801.  
  802.  
  803. ---------------------------------------
  804.     11. Building a finished product
  805. =======================================
  806.  
  807. The one-step Compile Project command in Orpheus 1 has been replaced by the
  808. Build Project dialog on the Project Menu.  While you can still produce a
  809. finished product with a single command, the Build dialog gives you access
  810. to the intermediate steps, for an enormous increase in speed and convenience.
  811.  
  812.     Users who have worked with certain other hypertext systems are often
  813.     afraid that "building a finished product" means losing their UNfinished
  814.     work or the ability to change it.  Not so with Orpheus.  None of the
  815.     Build stages has the slightest effect on your uncompiled cards.  You can
  816.     build and distribute a finished version on Monday, make corrections or
  817.     additions on Tuesday, and send out a new version on Wednesday (or as
  818.     often and as quickly as you like).
  819.  
  820. With your TEST project loaded, open the Project Menu and select "Build".
  821. As you can see, this dialog offers you a number of options, but all of the
  822. action takes place with a single keypress, <F10:Begin>.  Normally, you'll
  823. leave your options at the most convenient settings:  in the Scope box,
  824. select "Project"; this means that when looking for cards to compile, Orpheus
  825. checks the entire project.  In the Selection box, select "Compile if new or
  826. changed"; this tells Orpheus not to waste time recompiling cards that have
  827. already been compiled.  The Options box you can ignore for the time being, but
  828. later you may want to increase the "Largest file" setting; this tells Orpheus
  829. when to stop adding to one finished-product file and start another.  Finally,
  830. the Action box is where you tell Orpheus which of the build stages to perform
  831. when you press <F10>.
  832.  
  833.     In the Compile stage, Orpheus compiles your cards into the form they'll
  834.     have in your finished product:  Text cards are compressed, while Graphic
  835.     and Event cards are transformed from English-language scripts into binary
  836.     code.  Compiled cards are stored in files with a "CMP" extension, one
  837.     for each storage directory in a project.  The Simulator (a simulation
  838.     of the Orpheus Reader) works exclusively with CMP files.
  839.  
  840.     The Verify stage starts out from the Homecard and, using link-records
  841.     stored in the CMP files, explores every possible link it can find to every
  842.     card or data field in your project.  If a card contains a link to
  843.     something you've deleted, Verify finds the problem and tells you about it;
  844.     if a link that should point to an Event card points to a Text card (or
  845.     vice-versa), Verify tells you about it.  At the end of verification a
  846.     complete list of *everything* needed to go into your finished product is
  847.     stored in the NODELIST file in your project directory.
  848.  
  849.     The Assemble stage consults the NODELIST and puts together your finished
  850.     product, drawing upon the precompiled parts stored in your CMP files and
  851.     elsewhere.  It is extremely fast.  If you make a minor change to a project
  852.     that has already been assembled, such as a new color scheme, you can
  853.     reassemble the project (skipping the other two stages) and have a new
  854.     finished product in seconds.
  855.  
  856. By default, the Action box is set to #1, "Compile only".  This is because
  857. you have no need of the other stages during most of the development period
  858. that you will devote to a given project.  Why assemble a finished product
  859. you're only half way there?  On the other hand, *compiling* should be done
  860. on a regular basis throughout development, at the end of the day or when you
  861. take a coffee break.  No, you don't HAVE to do it, but I advise it, for two
  862. reasons.  First, as long as the Selection box is set to "Compile if new or
  863. changed", you will compile incrementally, catching only those cards that you
  864. have added or edited since last compiling.  This means that regular compiling
  865. doesn't waste you any time, while it does promise extremely fast final-assembly
  866. when the time comes.  Second, anything that is compiled can be viewed in the
  867. Simulator, which looks and behaves just like the Reader when it loads your
  868. finished product.  (If you use Graphic and/or Event cards, you'll depend on
  869. the Simulator to debug your scripts.)
  870.  
  871. Now let's do a test build of the TEST project.  For this demonstration I'd
  872. like you to change the Action box setting to #4, "Compile->Verify->Assemble".
  873. When this is done, press <F10:Begin> and watch the builder go to work.
  874.  
  875. Fast enough for you?  Now let's see what your cards look like in the
  876. Simulator.  Open the Project Menu and select "Simulate Reader".  A message
  877. box reminds you that you can hotkey out of the Simulator by pressing <Alt-F4>.
  878. (This is an emergency exit in case you paint yourself into a corner later on:
  879. if you disable the default Exit hotkey -- <Alt-X> in the English-language
  880. version -- and if you forget to provide an Exit command button of your own,
  881. you won't have any other out except a reboot.)  Once in the Simulator, you'll
  882. notice the presence of a titlebar displaying the title of your project and a
  883. couple of command buttons.  (As of version 2.00.17 the Esc:Menu button does
  884. nothing, neither in the Simulator nor if you use it in the Reader.  Check
  885. the documentation on this if you have a later version.)
  886.  
  887. Important to know right now:  YOU DO NOT HAVE TO USE THIS TITLEBAR IN YOUR OWN
  888. WORK.  Later on, open the Project Menu and select "Project Options", then
  889. "Screen Layout".  Check it out and press <F1> for guidance.  You can customize
  890. the appearance and functionality of your work in many, many ways.  An example
  891. is online Help, which as I may have mentioned, was created as an Orpheus
  892. project.  The appearance of Help, including the command buttons along the
  893. bottom row, was set up in the Screen Layout dialog.  You can use a frame, a
  894. titlebar, a commandbar, and put buttons and topics and your title upon them,
  895. but you can also use absolutely none of these, or pick and choose and work up
  896. a layout that looks custom-programmed.
  897.  
  898. Exit the Simulator with <Alt-X> or <Alt-F4>.  Now let's test your work in
  899. the Orpheus Reader, since you assembled an HTX as the end result of your
  900. build command.  Quit OH.EXE by pressing <Alt-F4>.  At the DOS prompt, start
  901. up the Reader with the name of the project as the sole parameter:
  902.  
  903.         ohread test
  904.  
  905. The Reader should load TEST.HTX, and it will look exactly like what you just
  906. saw in the Simulator.  The difference is that, if you are a registered user,
  907. you can distribute your HTX with the Orpheus Reader, or install it on a LAN
  908. as a corporate (or institutional) information system.  Press <Alt-X> to exit
  909. the Reader.
  910.  
  911. Now you have seen the bare essentials of how to use Orpheus.  The rest is up
  912. to you.  We've touched on only a fraction of what you can achieve with this
  913. system, but most of it is as easy as what we've just done.  Explore the menus
  914. and dialogs, dig into Help, experiment.  MAKE STUFF, and keep in touch.
  915.  
  916.  
  917.  
  918. Rod Willmot     => willmot@interlinx.qc.ca
  919. ==============================================================================
  920.  
  921.  
  922.  
  923.                          = Appendix - How to Order =
  924. :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
  925.  
  926. The following order form is also provided separately in REGISTER.TXT.
  927.  
  928.  
  929.  
  930.                                    ORDER FORM
  931.  
  932.     Please send me a registered copy of the latest version of Orpheus.
  933.     I understand that I will receive a Licence granting me the right to
  934.     sell, give away, or otherwise distribute any compiled electronic works
  935.     that I create with Orpheus, along with the Orpheus Reader.  In accepting
  936.     this Licence I agree not to compile and distribute works created by
  937.     others using shareware copies of Orpheus.
  938.  
  939.  
  940.  +=====+=========================================+=======+============+=======+
  941.  | Qty |            Product Description          | Price |  Shipping  | Total |
  942.  +=====+=========================================+=======+============+=======+
  943.  |     |                                         |       | US/Can  $3 |       |
  944.  |  1  | Orpheus Hypertext Authoring System      | $79 US| Other   $6 | _____ |
  945.  +-----+-----------------------------------------+-------+------------+-------+
  946.  |     |  For an affordable site licence, or for a customized version |       |
  947.  |     |  built to your specifications, please call 1-819-566-6296.   |   -   |
  948.  +=====+=========================================+=======+============+=======+
  949.                 * Prices are in US dollars*                    Total  | _____ |
  950.                                                                       +=======+
  951.  
  952.     Name:    ________________________________________________
  953.     Address: ________________________________________________
  954.              ________________________________________________
  955.              ________________________________________________
  956.     Phone:   (work)_________________  (home)_________________
  957.     Fax:     ______________________
  958.     Email:   ________________________________________________
  959.  
  960.     Preferred disk format:  [_] 3.5-inch (720K)     [_] 5.25-inch (360K)
  961.                             [_] 3.5-inch (1.44M)    [_] 5.25-inch (1.2M)
  962.  
  963.     Method of payment:  [_] check or money order enclosed
  964.                         [_] purchase order # ____________________
  965.                         [_] credit card (see below)
  966.  
  967.       *Canadian and overseas orders must be in US dollars, OR the equivalent
  968.        value in Canadian dollars according to the exchange rate when ordering.
  969.  
  970.     I have Version ____ of Orpheus, obtained from: ___________________________
  971.  
  972.     Comments: ________________________________________________________________
  973.               ________________________________________________________________
  974.  
  975.  
  976.                                Hyperion Softword
  977.                                535 Duvernay
  978.                                Sherbrooke, QC
  979.                                Canada J1L 1Y8
  980.  
  981.      *** U.S. customers:  Please use a 40-cent stamp on mail to Canada. ***
  982.  
  983.  ============================================================================
  984.                            * Credit Card Orders *
  985.  ============================================================================
  986.  
  987. The following information tells how to purchase Orpheus by credit card.
  988. Credit card orders are processed by Public Software Library, a fine company
  989. located in Houston, Texas (USA).  When it receives your order, PSL sends
  990. me a fax with your name and address, and I mail you your registered copy of
  991. the latest version of Orpheus.  From then on you are a customer of Hyperion
  992. Softword, receiving information, tech support, upgrades, directly from me.
  993.  
  994. If you need information about Orpheus, call Hyperion Softword, not PSL!
  995. PSL cannot tell you anything about Orpheus, but I certainly can.  You can
  996. reach Hyperion Softword at 819-566-6296 (email: willmot@interlinx.qc.ca).
  997.  
  998.  
  999. ===============================================================================
  1000. Credit card order of Orpheus (PSL #11142) from Public Software Library:
  1001.  
  1002. Fax:   713-524-6398
  1003. Voice:   713-524-6394
  1004. CIS:  71355,470
  1005. Post:  Public Software Library, P.O. Box 35705, Houston, TX 77235-5705, USA.
  1006.  
  1007.       * Please enter your name as it appears on your card,
  1008.       * and the address where you receive your credit card bills.
  1009.  
  1010. Name:
  1011. Address:
  1012.  
  1013.  
  1014. Shipping address (if different):
  1015.  
  1016.  
  1017. Telephone:
  1018. Fax:
  1019. Email:
  1020.  
  1021. Credit card:  [  ] Visa    [  ] Mastercard    [  ] American Express
  1022.               [  ] Discover
  1023.  
  1024. Card number: _________________________________ Expiry: ________________
  1025.  
  1026. Signature: ____________________________________
  1027.  
  1028. ===============================================================================
  1029.